home *** CD-ROM | disk | FTP | other *** search
/ Compatibles PC Magazine 22 / PC Mag HS 22 CD2.iso / sharewar / dos / notice / notice.not < prev    next >
Encoding:
INI File  |  1994-11-12  |  18.9 KB  |  481 lines
  1. [T:NOTICE 1.0, Manuel d'utilisation]
  2.  
  3.             ╔═════════════════════════════════════════════╗
  4.             ║                 NOTICE 1.0                  ║
  5.             ║   Copyright (c) 1994, Christophe Bouscaut   ║
  6.             ╚═════════════════════════════════════════════╝
  7.  
  8.  
  9.  
  10. [J]
  11.    ┌────────────────────────────────────────────────────────────────────────┐
  12.    │   INFORMATION: Ce texte dispose d'un menu interne, que vous pouvez     │
  13.    │                actionner par appui sur la touche 'M', à tout moment.   │
  14.    └────────────────────────────────────────────────────────────────────────┘
  15.  
  16. [N]
  17.     Comme son nom l'indique, NOTICE va vous permettre de réaliser des 
  18.     notices d'utilisation, manuels, livres, démonstration de logiciels,
  19.     à partir d'un simple fichier texte.
  20.     Vous avez la possibilité d'égayer votre texte, par l'ajout de 
  21.     couleurs, l'intégration d'un menu interne pour une consultation
  22.     rapide, ainsi que donner la possibilité à votre lecteur de lancer
  23.     des fichiers exécutables, depuis n'importe quel endroit du texte.
  24.  
  25.     Le fichier de documentation que vous êtes en train de consulter
  26.     illustre ces possibilités. Vous pouvez l'afficher en utilisant 
  27.     le programme EDIT du DOS (fichier NOTICE.DOC), pour voir comment
  28.     il a été réalisé.
  29.  
  30.     NOTICE est une version "allégée" de PC-Texte 2.0, un autre logiciel
  31.     du même auteur, servant à réaliser des publications électroniques
  32.     plus volumineuses (voir catalogue).
  33.  
  34.  
  35.  
  36. [M:Ecriture du corps du texte]
  37. [J]
  38.  
  39.    ECRITURE DU CORPS DU TEXTE
  40.    ───────────────────────────────────────────────────────────────────────
  41. [N]
  42.  
  43.    Vous pouvez écrire le corps de votre texte avec n'importe quel éditeur
  44.    ou traitement de texte, permettant la sauvegarde des documents au
  45.    format texte ASCII, par exemple EDIT, présent dans les versions 5.0
  46.    et ultérieures du DOS.
  47.  
  48.    Seules obligations: vous devez impérativement nommer ce fichier
  49.    NOTICE.NOT, et l'enregistrer au format ASCII.
  50.    Ensuite, il ne vous reste qu'à le copier dans le répertoire où est 
  51.    installé NOTICE.
  52.    
  53.    Vous pouvez alors directement l'afficher en tapant NOTICE à l'invite
  54.    du DOS.
  55.  
  56.    La lecture des chapitres suivants vous montrera comment faire pour rendre 
  57.    ce texte plus "intéractif". 
  58.  
  59. [B]
  60.    Important!
  61. [N]
  62.    Le texte de ce présent manuel est fourni en double exemplaire sur la 
  63.    disquette, sous deux noms différents:
  64.  
  65.     - NOTICE.NOT (que vous devrez remplacer par votre propre fichier 
  66. portant le même nom).
  67.  
  68.     - NOTICE.DOC (que vous pouvez consulter avec un éditeur, si vous 
  69. souhaitez visualiser les symboles utilisés par NOTICE, ou en tapant 
  70. NOTICE notice.doc à l'invite du DOS, pour une consultation normale du manuel 
  71. d'utilisation de ce logiciel).
  72.  
  73.    Par ailleurs le texte contenu dans NOTICE.NOT ne doit pas dépasser
  74.    200 Ko, ceci afin de s'assurer que la visualisation pourra s'effectuer
  75.    dans de bonnes conditions sur la plupart des systèmes. Les éventuels 
  76.    fichiers exécutables à lancer pendant la consultation ne devront pas
  77.    dépasser 140 Ko.
  78.  
  79.  
  80. [M:Attribution de couleurs d'affichage]
  81. [J]
  82.    ATTRIBUTION DE COULEURS D'AFFICHAGE POUR LES TEXTES
  83.    ──────────────────────────────────────────────────────────────────────────
  84.  
  85. [N]
  86.    Comme vous l'avez remarqué, les titres du fichier texte que vous êtes
  87.    en train de consulter sont en jaune, et certaines portions de textes
  88.    apparaissent avec des couleurs différentes. Cela est dû à l'ajout de
  89.    symboles précis, que NOTICE interprête pour retranscrire le résultat
  90.    à l'affichage.
  91.    Pour en avoir un aperçu, éditez ce fichier (NOTICE.DOC), à partir du
  92.    programme EDIT du DOS.
  93.  
  94.    Voici les différents symboles reconnus lors d'une visualisation par 
  95.    NOTICE, concernant les couleurs:
  96.  
  97.           [R] signifie: à partir de la ligne suivante, le texte s'inscrit
  98.                         en ROUGE.
  99.  
  100.           [V] signifie: à partir de la ligne suivante, le texte s'inscrit
  101.                         en VERT.
  102.  
  103.           [B] signifie: à partir de la ligne suivante, le texte s'inscrit
  104.                         en BLEU.
  105.  
  106.           [J] signifie: à partir de la ligne suivante, le texte s'inscrit
  107.                         en JAUNE.
  108.  
  109.           [N] signifie: à partir de la ligne suivante, le texte reprend
  110.                         sa COULEUR NORMALE.
  111.  
  112.      La COULEUR NORMALE est, par défaut, blanc sur fond bleu foncé, ou
  113.      noir sur fond blanc, selon que vous appuyiez ou non sur la touche
  114.      <ESPACE> pendant la visualisation.
  115.      Lors d'une visualisation sur fond bleu, les éventuelles couleurs
  116.      définies par l'utilisateur seront en mode "brillant". Lors d'une
  117.      visualisation sur fond blanc, celles-ci seront en mode "foncé",
  118.      ceci s'effectue automatique, pour conserver une bonne lisibilité.
  119.  
  120.     ** A noter **
  121.     Le "[" s'obtient en maintenant la touche "Alt Gr" appuyée, pendant
  122.     que vous appuyez sur la parenthèse "(". Idem avec la parenthèse
  123.     ")" pour obtenir le signe "]".
  124.  
  125.  
  126. [R]
  127.      ** Important **
  128.      Pour être actifs, les signes [R], [V], [B], [J] et [N] doivent se
  129.      trouver tout à fait à GAUCHE de ligne, sur la première colonne.
  130.      Les éventuels caractères qui figureraient à droite de l'un de ces
  131.      signes seraient ignorés et non retranscris.
  132.      L'attribution de la couleur sera active à partir de la ligne 
  133.      SUIVANTE et jusqu'à ce qu'une autre couleur soit attribuée, par
  134.      exemple, [N] qui signifie, retour à la couleur normale, ou tout
  135.      autre couleur.
  136.  
  137. [N]
  138.      Prenons un exemple. Comme ces signes n'apparaissent pas lors d'une
  139.      visualisation sous NOTICE, nous allons les retranscrire avec
  140.      un espacement vers la droite , afin que vous puissiez les voir dans 
  141.      ce fichier.
  142.  
  143.  [B]
  144.     Ces deux lignes auraient dû s'inscrire en BLEU, si le signe [B] avait
  145.     été inscrit complètement à gauche de la ligne du dessus.
  146.  
  147.  [N]
  148.     Ce signe signifie un retour à la COULEUR NORMALE (blanc ou noir,
  149.     selon que l'utilisateur appuie sur la barre <ESPACE> ou non.
  150.  
  151.  
  152.   Par conséquent, lorsque vous écrirez vos textes, prenez soin de ne
  153.   pas attribuer de "marge à gauche".
  154.  
  155.  
  156. [M:Donner un titre au texte]
  157. [J]
  158.   DONNER UN TITRE AU TEXTE
  159.   ─────────────────────────────────────────────────────────────────────────
  160.  
  161. [N]
  162.   Lors de la visualisation de votre texte sous NOTICE, la première ligne
  163.   indique toujours le titre donné au fichier. Ce présent texte à donc
  164.   pour titre "NOTICE 1.0, Manuel d'utilisation".
  165.   Si vous voulez que NOTICE affiche un titre pour votre texte lors de sa
  166.   consultation, vous devez ajouter, sur la PREMIERE ligne du texte, la
  167.   mention suivante:
  168.            [T:ceci est le titre]
  169.   
  170.   Comme on l'a souvent dit, cette mention doit, elle aussi, se situer tout
  171.   à fait à gauche de la ligne.
  172.   Si vous n'attribuez pas de titre à votre texte, NOTICE affichera le
  173.   nom du fichier en cours de visualisation, en l'occurence le fichier
  174.   NOTICE.NOT .
  175.  
  176.  
  177.  
  178. [M:Permettre le lancement d'un programme]
  179. [J]
  180.   PERMETTRE LE LANCEMENT D'UN EXECUTABLE PENDANT LA VISUALISATION
  181.   ───────────────────────────────────────────────────────────────────────────
  182.  
  183. [N]
  184.   Nous allons maintenant voir comment, pendant la visualisation d'un texte, 
  185.   nous pouvons permettre au lecteur de lancer un ou plusieurs programmes 
  186.   exécutables, c'est à dire un fichier portant une de ces extensions:
  187.        .EXE, .COM ou .BAT .
  188.  
  189.   La syntaxe pour l'insertion d'un fichier exécutable à partir d'un
  190.   texte est la suivante:
  191.       
  192.           ┌────────────────────────────────────────────┐
  193.           │ [E:nomfich.ext]                            │
  194.           │ Appuyez sur ENTREE pour lancer NOMFICH.EXT │
  195.           └────────────────────────────────────────────┘
  196.  
  197.   Dans cet exemple, NOMFICH.EXT est le nom complet du programme à
  198.   lancer (avec son extension) et "Appuyez sur ENTREE pour lancer
  199.   NOMFICH.EXT" est le COMMENTAIRE (obligatoire) associé au lancement 
  200.   de ce fichier exécutable.
  201.  
  202.   Là encore, pour être effective, la ligne portant la mention 
  203.   [E:nomfich.ext] aurait dû être inscrite complètement A GAUCHE de la page.
  204.  
  205.   Prenons également un exemple. L'un des fichiers livrés avec NOTICE
  206.   est ESSMEM.BAT. Ce fichier contient tout simplement l'appel au
  207.   programme MEM, du DOS, et la mention PAUSE, qui demande à l'utilisateur
  208.   d'appuyer sur une touche avant de continuer. 
  209.   Voici le résultat, quand on écrit [E:essmem.bat] tout à fait à gauche,
  210.   et le commentaire "<ENTREE> = Voir la mémoire disponible" dans la ligne 
  211.   du dessous, ce commentaire pouvant se trouver à n'importe quel endroit de 
  212.   la ligne SUIVANTE (et obligatoirement la ligne suivante).
  213.  
  214.  
  215. [E:ESSMEM.BAT]
  216.                 <ENTREE> = Voir la mémoire disponible
  217.  
  218.   Si vous appuyez maintenant sur ENTREE, le programme ESSMEM.BAT s'exécute. 
  219.   A la fin de l'exécution, vous retournez à la visualisation du texte, 
  220.   exactement au même point que vous l'aviez quitté.
  221.  
  222.   Remarquez que le commentaire "<ENTREE> = Voir la mémoire disponile"
  223.   apparaît en ROUGE CLIGNOTANT. Il ne s'agit pas d'une attribution
  224.   de couleur. Tout fichier exécutable à lancer depuis la visualisation
  225.   d'un texte sous NOTICE à pour effet l'inscription en rouge clignotant
  226.   du COMMENTAIRE associé au lancement de ce fichier.
  227.  
  228.   Notez également que nous aurions pu, au lieu de ESSMEM.BAT, écrire
  229.   directement MEM, mais l'exécution se serait terminée par un retour
  230.   quasi-instantané au texte, sans nous laissez le temps de bien lire
  231.   l'affichage résultant de l'exécution de MEM. C'est pourquoi nous
  232.   avons lancé ESSMEM.BAT, qui contient la mention PAUSE, permettant
  233.   à l'utilisateur d'appuyer sur une touche pour retourner à PC-TEXTE.
  234.   Il est conseillé de procéder de même si vous souhaitez inclure 
  235.   l'exécution de certaines commandes DOS, comme la commande DIR, par 
  236.   exemple.
  237.  
  238.   Précisément, voici un exemple d'appel DIRECT de la commande DIR depuis 
  239.   la visualisation du présent texte. Vous remarquerez, après avoir appuyé 
  240.   sur ENTREE que l'affichage des fichiers est immédiatement suvi par un 
  241.   retour à la visualisation du fichier sous NOTICE.
  242.  
  243.  
  244. [E:DIR]
  245.                Appuyez sur ENTREE pour lister les fichiers
  246.  
  247.  
  248.   Voila pourquoi il aurait été opportun, dans ce cas, de créer un fichier
  249.   .BAT contenant l'appel à la fonction DIR, suivi de PAUSE. Cela aurait
  250.   permis à l'utilisateur de consulter tranquilement les fichiers, et
  251.   appuyer sur une touche pour revenir à la consultation du texte. Il
  252.   aurait donc suffit d'appeler directement un tel fichier .BAT, par
  253.   exemple:  
  254.      
  255.       ┌────────────────────────────────────────────────────┐
  256.       │  [E:ESSDIR.BAT]                                    │
  257.       │  ** Appuyez sur ENTREE pour lister les fichiers ** │
  258.       └────────────────────────────────────────────────────┘
  259.  
  260.  
  261. [V]
  262.   Remarques importantes
  263.   ---------------------
  264.  
  265. [N]
  266.   Seule la touche ENTREE est utilisée pour lancer des fichiers exécutables
  267.   depuis la consultation d'un texte. Le commentaire, obligatoire, devra
  268.   donc toujours comporter une mention du type "<ENTREE> = ..." ou "Appuyez
  269.   sur ENTREE pour...", afin que le lecteur sache comment procéder.
  270.  
  271.   Bien entendu, l'action affichée dans le commentaire clignotant ne peut
  272.   s'exécuter que si elle est visible à l'écran. Cependant, dans le cas
  273.   où vous placiez deux commentaires relatifs à l'exécution d'un programme, 
  274.   visibles en même temps, c'est à dire espacés par moins de 20 lignes l'un 
  275.   de l'autre, l'appui sur la touche ENTREE aurait pour effet l'exécution du 
  276.   programme décrit dans le commentaire situé le plus "haut" dans le texte.
  277.  
  278.   Les exemples de programmes (affichage des fichiers du répertoire, de
  279.   la mémoire disponible) n'ont que peu d'intérêt, et n'ont été inclus
  280.   qu'à titre d'exemple. Selon votre projet, il est évident que vous
  281.   pourrez lancer n'importe quel programme (toutefois inférieur à 380 Ko).
  282.   Cela peut-être une image exécutable, un logiciel, un morceau musical,
  283.   une démo, un programme d'installation de logiciel, etc...
  284.  
  285.   A la fin du présent texte, vous aurez la possibilité de lancer un
  286.   programme qui sortira sur imprimante la syntaxe des différentes
  287.   options (couleurs, fichiers exécutables, menus internes) reconnues
  288.   par NOTICE.
  289.  
  290.  
  291.  
  292. [M:Incorporer un menu interne]
  293. [J]
  294.   INCORPORER UN MENU INTERNE DANS UN TEXTE
  295.   ───────────────────────────────────────────────────────────────────────────
  296.  
  297. [N]
  298.   Le présent texte en corporte justement un tel menu interne.
  299.   Rappel: vous pouvez l'appeler à tout moment en appuyant sur la touche 'M'.
  300.  
  301.   L'incorporation d'un tel menu est d'un très grande simplicité. Il vous
  302.   suffit de placer, aux endroits opportuns de votre texte, la mention:
  303.  
  304.                 ┌───────────────────────────────┐
  305.                 │  [M:nom de l'option de menu]  │
  306.                 └───────────────────────────────┘
  307.   
  308.   Là encore, cette inscription doit, bien entendu, se trouver tout à fait
  309.   à gauche de la page.
  310.   Vous pouvez ainsi placer jusqu'à 500 options de menus dans votre texte. 
  311.   Chaque option de menu interne correspond à un endroit précis du texte: 
  312.   l'endroit où vous l'aurez placée!
  313.  
  314.   Prenons l'exemple d'un texte court:
  315.   
  316.  
  317.  [M:premier paragraphe]
  318.          
  319.          PARAGRAPHE 1
  320.          ligne 1 ligne 1 ligne 1 ligne 1 ligne 1 ligne 1 ligne 1
  321.          ligne 2 ligne 2 ligne 2 ligne 2 ligne 2 ligne 2 ligne 2
  322.          ligne 3 ligne 3 ligne 3 ligne 3 ligne 3 ligne 3 ligne 3
  323.          ligne 4 ligne 4 ligne 4 ligne 4 ligne 4 ligne 4 ligne 4
  324.  
  325.  [M:deuxième paragraphe]
  326.  
  327.          PARAGRAPHE 2
  328.          ceci est la première ligne du deuxième paragraphe
  329.          ceci est la deuxième ligne du deuxième paragraphe
  330.          ceci est la troisième ligne du deuxième paragraphe
  331.  
  332.  [M:troisième paragraphe]
  333.  
  334.          PARAGRAPHE 3
  335.          ligne 1 ligne 1 ligne 1 ligne 1 ligne 1 ligne 1 ligne 1
  336.          ligne 2 ligne 2 ligne 2 ligne 2 ligne 2 ligne 2 ligne 2  
  337.          ligne 3 ligne 3 ligne 3 ligne 3 ligne 3 ligne 3 ligne 3
  338.          ligne 4 ligne 4 ligne 4 ligne 4 ligne 4 ligne 4 ligne 4
  339.  
  340.   Pour que ces trois options soient REELEMENT incluses dans le menu
  341.   interne, il aurait fallu écrire les mentions [M:nom de l'option]
  342.   complétement à gauche de la page.
  343.  
  344. [B]  
  345.               ╔═════════MENU═════════╗
  346.               ║ premier paragraphe   ║
  347.               ║ deuxième paragraphe  ║
  348.               ║ troisième paragraphe ║
  349.               ╚══════════════════════╝
  350.  
  351. [N]
  352.   Ce menu est généré automatiquement par NOTICE, vous n'avez qu'à placer 
  353.   des mentions [M:titre de l'option] aux endroits adéquats de votre texte, 
  354.   et NOTICE se charge de gérer tous le reste!
  355.  
  356.   Ce menu aurait été directement accessible par l'utilisateur, lors de
  357.   la visualisation du texte sous PC-TEXTE, par appui sur la touche 'M',
  358.   et ce depuis n'importe quel endroit du texte.
  359.  
  360.   Une fois le menu sélectionné par 'M', il faut appuyer sur les touches
  361.   fléchées puis ENTREE pour sélectionner l'option choisie. Ensuite, NOTICE 
  362.   se positionne automatiquement à l'endroit du texte correspondant à 
  363.   l'option de menu choisie.
  364.  
  365. [V]
  366.   Pour tester cette fonction depuis le menu interne du texte que vous êtes 
  367.   en train de consulter, appuyez maintenant sur la touche 'M', et utilisez 
  368.   les flèches de direction puis la touche ENTREE.
  369.  
  370. [N]
  371.   Bien évidemment, l'introduction d'un tel menu interne ne se justifie
  372.   que dans le cas où votre texte est relativement long. Cela permet ainsi
  373.   à vos lecteur de pouvoir "naviguer" rapidemment dans le texte, et
  374.   se positionner rapidemment sur le chapitre contenant les informations
  375.   qu'ils recherchent.
  376.  
  377.  
  378. [M:Diffusion de vos réalisations]
  379. [J]
  380.   LA DIFFUSION DE VOS REALISATIONS
  381.   ────────────────────────────────────────────────────────────────────────
  382.  
  383. [N]
  384.   Pour diffuser votre oeuvre, il suffit de copier sur une disquette les
  385.   deux fichiers suivants:
  386.         - NOTICE.EXE 
  387.     - votre fichier texte obligatoirement nommé NOTICE.NOT 
  388.  
  389. [V]
  390.   Si vous souhaitez permettre à votre lecteur de visualiser un autre texte 
  391.   que celui contenu dans NOTICE.NOT, utilisez le programme EDIT du DOS pour 
  392.   créer un fichier ".BAT" de lancement, par exemple CATALOG.BAT, qui pourrait
  393.   contenir les lignes suivantes:
  394.  
  395.     @ECHO OFF
  396.     CLS
  397.     NOTICE catalog.txt
  398.  
  399. [N]
  400.   Ainsi, vos lecteurs n'auront qu'à taper, par exemple, CATALOG, depuis le 
  401.   DOS, pour afficher directement le fichier texte que vous spécifiez dans
  402.   le fichier ".BAT".
  403.   
  404.   Seuls les utilisateurs enregistrés sont autorisés à diffuser leurs
  405.   créations réalisées avec NOTICE. Le prix de la licence d'utilisation de 
  406.   ce logiciel est de 50 Frs. Les réglements doivent être libéllés à l'ordre
  407.   de Christophe Bouscaut, et expédiés à l'adresse suivante:
  408.  
  409.           ┌────────────────────────────────────────────────┐
  410.           │              Christophe Bouscaut               │
  411.           │                    NOTICE                      │
  412.           │    8 allée de la Rigale - 33170 Gradignan      │
  413.           └────────────────────────────────────────────────┘
  414.  
  415.   Les utilisateurs enregistrés reçoivent également en cadeau le logiciel
  416.   SHAREWARE DIRECT. Lancez CATALOG.BAT pour voir sa description.   
  417.  
  418.  
  419. [E:IMPRBON.BAT]
  420.     ****** Appuyez sur ENTREE pour imprimer le bon de commande ******
  421.  
  422.  
  423.  
  424. [M:En guise de conclusion]
  425. [J]
  426.   EN GUISE DE CONCLUSION
  427.   ─────────────────────────────────────────────────────────────────────────
  428.  
  429. [N]
  430.   Nous venons de réaliser un rapide survol des fonctionnalités de NOTICE. 
  431.   Vous savez maintenant quelles sont les possibilités qui s'offrent à
  432.   vous. A vous maintenant de créer vos propres notices, livres, démos, etc... 
  433.   
  434.   A présent, vous avez la possibilité d'imprimer le fichier SYMBOLES.TXT,
  435.   qui résume la syntaxe des "instructions" que peuvent comporter vos
  436.   textes, si vous souhaitez que NOTICE les affiche en ajoutant des
  437.   enrichissements: couleurs, lancement de programmes, menus internes.
  438.  
  439.   Comme annoncé en début de texte, vous pouvez dès maintenant imprimer
  440.   les symboles utilisés par NOTICE, ce qui vous évitera de consulter
  441.   ce texte trop souvent. Il vous suffit d'appuyer sur ENTREE dès que
  442.   vous voyez le message clignotant correspondant.
  443.  
  444.  
  445. [E:impr_sym.BAT]
  446.   **> ENTREE= impression de la syntaxe des symboles reconnus par NOTICE <** 
  447.  
  448.  
  449. [J]
  450.   RAPPEL IMPORTANT
  451.   ----------------
  452.  
  453. [N]
  454.   Lancer "NOTICE" depuis le DOS, provoque l'affichage du fichier NOTICE.NOT.
  455.   Lancer "NOTICE nomfich.txt", provoque l'affichage du fichier spécifié.
  456.  
  457.  
  458. [B]
  459.                           A vous de jouer !
  460.  
  461.  
  462.  
  463. [N]
  464.      Pour tout renseignement, n'hésitez pas à contacter l'auteur:
  465.      Christophe Bouscaut - 8 allée de la Rigale - 33170 Gradignan
  466.      Tél. 56 89 38 49 - Fax. 56 89 12 88
  467.  
  468.  
  469.      ******************** Regard sur PC-TEXTE 2.0 ********************
  470.  
  471.      Si vous souhaitez aller plus loin et créer des publications
  472.      électroniques multi-documents et multi-projets, reportez-vous
  473.      à la description du logiciel PC-TEXTE 2.0, en lançant le fichier
  474.      CATALOG.BAT .
  475.  
  476.      *****************************************************************
  477.  
  478.  
  479.  
  480.    
  481.